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LICENSE AGREEMENT 


NOTE: This is a copy of the License Agreement which you agreed to before opening 
the package which includes this User’s Manual. The License Agreement is placed 
here solely for your convenience. 


READ THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT 
CAREFULLY BEFORE OPENING THE PACKAGE CONTAINING THE PROGRAM 
DISKETTE, THE COMPUTER SOFTWARE THEREIN, THE SECURITY KEY, AND 
THE ACCOMPANYING USER DOCUMENTATION (THE "PROGRAM”). THE 
PROGRAM IS COPYRIGHTED AND LICENSED (NOT SOLD). BY OPENING THE 
PACKAGING CONTAINING THE PROGRAM, YOU ARE ACCEPTING AND 
AGREEING TO THE TERMS OF THIS LICENSE AGREEMENT. IF YOU ARE NOT 
WILLING TO BE BOUND BY THE TERMS OF THIS LICENSE AGREEMENT, YOU 
SHOULD PROMPTLY RETURN THE PACKAGE IN UNOPENED FORM, AND YOU 
WILL RECEIVE A REFUND OF YOUR MONEY. THIS LICENSE AGREEMENT 
REPRESENTS THE ENTIRE AGREEMENT CONCERNING THE PROGRAM 
BETWEEN YOU AND MAD MAN SOFTWARE, INC. (REFERRED TO AS 
"LICENSOR"), AND IT SUPERSEDES ANY PRIOR PROPOSAL, REPRESENTATION, 
OR UNDERSTANDING BETWEEN THE PARTIES. 

1. LICENSE GRANT. 

Licensor hereby grants to you, and you accept, a nonexclusive license to use the Security Key, 
the Program Diskette and the computer programs contained therein in machine-readable, 
object code form only (collectively referred to as the "Software"), and the accompanying User 
Documentation, only as authorized in this License Agreement. The Software may be used only 
on a single computer owned, leased, or otherwise controlled by you; or in the event of the 
inoperability of that computer, on a backup computer selected by you. Neither concurrent use 
on two or more computers nor use in a local area network or other network is permitted 
without separate authorization and the payment of other license fees. You agree that you will 
not assign, sublicense, transfer, pledge, lease, rent, or share your rights under this License 
Agreement. You agree that you may not reverse assemble, reverse compile, or otherwise 
translate the Software. 

Upon loading the Software into your computer, you may retain the Program Diskette for 
backup purposes. In addition you may make one copy of the Software on a second diskette 
(or on cassette tape) for the purpose of backup in the event the Program Diskette is damaged 
or destroyed. You may make one copy of the User’s Manual for backup purposes. Any such 
copies of the Software or the User’s Manual shall include Licensor’s copyright and other 
proprietary notices. Except as authorized under this paragraph, no copies of the Program or 
any portions thereof may be made by you or any person under your authority or control. 
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2. LICENSOR’S RIGHTS. 


You acknowledge and agree that the Software and the User’s Manual are proprietary products 
of Licensor protected under U.S. copyright law. You further acknowledge and agree that all 
right, title, and interest in and to the Program, including associated intellectual property rights, 
are and shall remain with Licensor. This License Agreement does not convey to you an 
interest in or to the Program, but only a limited right of use revocable in accordance with the 
terms of this License Agreement. 

3. LICENSE FEES. 

The License Fees paid by you are paid in consideration of the licenses granted under this 
License Agreement 

4. TERM. 

This License Agreement is effective upon your opening of this package and shall continue until 
terminated. You may terminate this License Agreement at any time by returning the Program 
and all copies thereof and extracts therefrom to Licensor. Licensor may terminate this License 
Agreement upon the breach by you of any term hereof. Upon such termination by Licensor, 
you agree to return to Licensor the Program and all copies and portions thereof. 

5. LIMITED WARRANTY. 

Licensor warrants, for your benefit alone, for a period of (90) days from the date of 
commencement of this License Agreement (referred to as the "Warranty Period") that the 
Security Key and the Program Diskette in which the Software is contained are free from 
defects in material and workmanship. Licensor further warrants, for your benefit alone, that 
during the Warranty Period the Program shall operate substantially in accordance with the 
functional specifications in the User’s Manual. If during the Warranty Period a defect in the 
Program appears, you may return the Program to Licensor for either replacement or, if so 
elected by Licensor, refund of the amounts paid by you under this License Agreement. You 
agree that the foregoing constitutes your sole and exclusive remedy for breach by Licensor of 
any warranties made under this License Agreement. EXCEPT FOR THE WARRANTY SET 
FORTH ABOVE, THE PROGRAM, AND THE SOFTWARE CONTAINED THEREIN, 
ARE LICENSED "AS IS," AND LICENSOR DISCLAIMS ANY AND ALL OTHER 
WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT 
LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS 
FOR A PARTICULAR PURPOSE. 

6. LIMITATION OF LIABILITY. 

Licensor’s cumulative liability to you and any other party for any loss or damages resulting 
from any claims, demands, or actions arising out of or relating to this License Agreement shall 
not exceed the. License Fee [paid to Licensor for the use of the Program]. In no event shall 
Licensor be liable for any indirect, incidental, consequential, special, or exemplary damages 
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or lost profits, even if Licensor has been advised of the possibility of such damages. SOME 
STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR 
INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATION OR 
EXCLUSION MAY NOT APPLY TO YOU. 

7. GOVERNING LAW. 

This License Agreement shall be construed and governed in accordance with the laws of the 
State of Wyoming. 

8. CAUSE OF LITIGATION. 

If any action is brought by any party to this License Agreement against the other party 
regarding the subject matter hereof, the prevailing party shall be entitled to recover, in 
addition to any other relief granted, reasonable attorneys’ fees and expenses of litigation. 

9. SEVERABILITY. 

Should any term of this License Agreement be declared void or unenforceable by any court 
of competent jurisdiction, such declaration shall have no effect on the remaining terms hereof. 

10. WAIVER. 

The failure of either party to enforce any rights granted hereunder or to take action against 
the other party in the event of any breach hereunder shall not be deemed a waiver by that 
party as to subsequent enforcement of rights or subsequent actions in the event of future 
breaches. 
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INTRODUCTION 


The Compression Kit (CKit) marks the first product ever released by Mad Man Software. It 
is actually the second project taken on by the Mad staff. 

The CKit was designed to fill a need at Mad Man Software for a RELIABLE backup utility 
with a REAL verify option that would work on ALL of the company’s computers and drives. 
This need was created by the development of Messiah III, a gigantic six disk side, state-of-the- 
art role-playing game for the Commodore 64/128. After using the CKit, and considering that 
Mad Man Software’s., specialty is entertainment software, you will better understand the 
magnitude of the previous statement. 

The first feature that you will notice, is that the CKit is easy to use. It is designed to allow you 
to choose the utility that you want to use, the drives you that wish to use it with, and the 
options that you want, in the least number of steps possible. Thereby eliminating the use of 
cryptic command codes often found in other utilities. Every main menu includes the ability 
to return to the previous menu, with all of your previous settings intact. The CKit even 
remembers which utilities are presently in memory (which can be a great time saver). 

The CKit is a backup utility. Accordingly, it contains strong error recovery features. If you 
are having problems reading a certain disk or file, you may find that the CKit might be able 
to recover it with its "Try again (y/n)" options. The verify options are especially powerful on 
the CKit. Not only can the CKit verify that your compressed backups are accurate, it can also 
verify that your decompressed backups are accurate. This actually makes the CKit more 
reliable than standard disk and file copiers. Of course, the big bonus of using the CKit to 
backup your files, disks, and partitions is that the backups are compressed and consume less 
space. 

The CKit’s friendly user interface should ease the pain of backing up your valuable data. 
Hopefully the CKit will encourage you to backup your files, disks, and partitions on a timely 
basis; and provide you a reliable means of recovering important data when things inevitably 
do go wrong. 

The staff at Mad Man Software thanks you for your purchase. 
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■ Chapter 1: RULES 

Here are five simple rules which will help keep you out of trouble when using the Compression 
Kit (CKit). 

1. Always Keep The Security Key Plugged In. 

Make sure that you plug the Security Key into joystick port #1 of your Commodore. The CKit 
can not operate without it. If by chance you forget to plug in the Security Key, the CKit will 
remind you after it boots up. 

Once you begin using the CKit, DO NOT REMOVE THE SECURITY KEY. The CKit relies 
on the Security Key for certain functions, and will crash if the Security Key is not present. 

Additionally, the CKit will crash if alterations are made to the internal code. So be sure you 
are using the authentic version of the CKit sent with this User’s Manual. 

2. No Software Based Fastloaders. 

The CKit uses almost all of the available memory on your Commodore 64. The CKit also 
makes extensive use of drive memory. For most software based fastloaders this makes for a 
deadly combination. Therefore, disable any and all software based fastloaders before booting 
the CKit 

Hardware based fastloaders which replace the Kernal ROM in your computer and disk 
drive(s), and retain all of the standard Commodore ROM calls (such as Creative Micro 
Designs’ JiffyDOS) should work flawlessly with the CKit. In fact using a product like 
JiffyDOS significantly enhances the performance of the CKit. 

3. Disk Drives Only On The Serial Bus. 

The CKit allows you to choose what drives you wish to use for certain jobs. During this 
process the CKit looks for devices one at a time, using the device numbers (8) through (29). 
Many third party printers and printer interfaces will lock up the serial bus if it receives a 
command which it does not understand (which consequently locks up your computer). There 
are also several printers which do not follow Commodore’s guidelines for serial bus activity 
(which can also lock up your computer). 

Your solution: When using the CKit make sure that your printer is shut OFF and that your 
printer interface is DISABLED. 


©1993 Mad Man Software, Inc. 


1 



RULES 


4. Do Not Use Software Set Device Numbers (1541). 

The CKit does not support software set device numbers. When the CKit encounters serious 
problems with the Commodore 1541, it sends a cold start reset command to the drive (which 
erases the software set device number). 

If you wish to use two or more 154l’s with the CKit you must physically change the device 
number(s) of the additional drive(s). The instructions for doing this can be found in your 
Commodore 1541 Disk Drive User’s Guide. Another option would be to purchase the low 
cost Drive Man from Devious Devices which allows you to both select device numbers and 
reset your drives at will. 

5. Do Not Use The Swap Buttons (CMD Devices). 

Under no circumstances should you use the swap buttons on your CMD device(s). The CKit 
understands device numbers (8) through (29), so there is no need to use those swap buttons. 
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■ Chapter 2: HARDWARE 

The Compression Kit (CKit) is designed for the Commodore 64 home computer (both the 
North American NTSC and European PAL versions). Consequently the CKit works with the 
following computers: 


Computer - 

f^DElllS 

Commodore 64 

Normal 

Commodore 64C 

Normal 

Commodore SX-64 

Normal 

Commodore 128 

64 Mode 

Commodore 128D 

64 Mode 


The CKit is designed and tested to work with the following drives and their associated DOS’s: 


—■— mu 


Commodore 1541 

CBM DOS V2.6 1541 

Commodore 1541C 

CBM DOS V2.6 1541 

Commodore 1541-11 

CBM DOS V2.6 1541 

Commodore 1571 

CBM DOS V3.0 1571 

Commodore 1581 

COPYRIGHT CBM DOS V10 1581 

CMD Hard Drive 

CMD HD DOS VI.82 

CMD RAMLink 

CMD RL DOS V2.00 

CMD RAMDrive 

CMD RD DOS V2.00 

CMD Floppy Drive 

CMD FD DOS VI.32 


Mad Man Software will continue to update the CKit as new drives and DOS’s become 
available. 


NOTE: See Chapter 12 for a description of hardware bugs found on early versions of the 
Commodore 1581. 
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■ Chapter 3: QUICK START 

The first thing you should do once you open the Compression Kit (CKit) is read Chapters 1 
through 6 and Chapter 12 of the User’s Manual. The second thing you should do is BACKUP 
your Program Diskette. Below is an outline which takes you step by step through a simple 
CKit backup procedure; so that you can backup your Program Diskette, and learn a little bit 
about the CKit at the same time. 

1. Plug the Security Key into joystick port #1. 

2. Insert the Program Diskette in your Commodore 1541 or 1571 disk drive and type: 
Commodore DOS 

LOAD"0:,[n],1 [return] 

JiffyDOS 


%0:* [return] 
or [shift][stop] 

Where [n] is the device number of the disk drive. The CKit will then automatically boot 
itself. 

3. Once the CKit finishes loading, it will place you in the Server. Now, using the cursor keys 
(use of the [ shift ] key is unnecessary) move the green light bar down a couple of positions 
so that it highlights Quit, then press [return]. 

4. You have exited the CKit, and are now in Commodore BASIC. To return back to the CKit 
type: 

SYS4 [return] 

This should place you right back, into the Server. 

5. Now select the Filemaster using the cursor keys, then press [return]. 

6. You are now in the Drive Selector. The green light bar should be highlighting the word 
"Drive" in the section labeled Source. Tap the [return] key until the device [n] which you 
booted the CKit from appears next to the word "Drive". 


NOTE: Did the computer lockup? Maybe you should read the five important rules in 
Chapter 1. If your computer did lock up, turn off and/or disable all the printers and 
printer interfaces, on the serial bus, then reset all of the drives (if you are still having 
problems, refer to Chapter 12). 
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QUICK START 


Now move the light bar down to the word "Drive" in the section labeled Destination, and tap 
the [return] key until you get the same device that you selected in the Source section. 

7. Now press the letter [a]. The CKit should show you a directory of the Source (Program 
Diskette). Now press [ return ] to return to the Drive Selector. 

8. Find a blank formatted 5.25" diskette. Remove the Program Diskette and replace it with 
the blank disk. Ptess the letter [b] to get a directory of the Destination diskette. 


NOTE: If you encounter a "READ ERROR", you probably have an unformatted disk. So 
you will need to format it. Press [return] to leave the error screen. Now press the 
number [2] to issue a DOS command to the Destination drive. Type the standard 
Commodore 1541 DOS format command. Example: 

NO:CK V1.00,CK [return] 

The drive should format the disk. When formatting is complete the CKit will display the 
error message on the command channel (which should say O.K.). Now press [ return ], 
then press the letter [b] to get a directory of your newly formatted diskette. 

Ordinarily Mad Man Software recommends that you format disks outside of the CKit. 


9. Return to the Drive Selector by pressing [ return ]. Now you are ready to backup your 
Program Diskette, so press [FI] to boot the Filemaster. 

10. Oops, you left the Destination diskette in the drive. No problem. Replace the 
Destination diskette with the Program Diskette and press [return]. 

11. You are now in the Filemaster. To make sure that you setup the Source and Destination 
correctly, press [«-] to abort Compare the Source and Destination drives. If they are not the 
same, use the cursor and [return] keys as before to correct them. Otherwise, press [FI] 
to reboot the Filemaster. Notice that the CKit did not reload the Filemaster since it was 
already in memory. 

12. You want to copy files. Use the cursor keys to place the light bar on Copy Files, then 
press [return]. The Filemaster will scan the directory for a second or two, then it will 
switch to its file selection screen. Try out all of the options except [ FI ]. Notice how selected 
files are marked RED, and unselected files are marked WHITE. Move the light bar around 
using the cursor keys (again use of the [ shift ] key is unnecessary). Tiy using the [ home ] 
key, try using the [shift] [home] combination, and try using [shift] [return]. These 
are time saving options which are not listed on the menu. 
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QUICK START 


13. Press [m] the mode key until the word "ASK" appears next to the word "Mode" in the 
status area; press [v] the verify key until the word "ON" appears next to the word "Verify" in 
the status area; and press [t] the toggle key until all of the files in the directory are selected 
(this should take only one key stroke, unless you have already selected all of the files and just 
deselected them all). Now press [FI] to begin the job. 

14. You are now on the job screen. In the status area, the Filemaster is asking "Begin Job - 
Are you sure (y/n)?" 'Press [n] for no. You are back on the file selection screen. Notice 
that all of your previous settings are intact To return to the job screen press [FI]. Now 
answer yes to "Begin Job - Are you sure (y/n)?" by pressing the [y] key. 

Immediately the job will begin. The Filemaster will fill up the buffer with all of the data that 
it can, then ask you to insert the Destination disk. Replace the Program Diskette with the 
backup diskette then press [return]. The Filemaster will save the first file, verify it, then 
move on to the next. You can follow this process by watching the Status and Buffer areas. 
After the Filemaster finishes saving all of the data in the buffer, the program will ask you to 
insert the Source disk. So insert the Program Diskette and press [return]. Follow this 
process until the copy is complete. 

You now have a verified backup of the files on your Program Diskette. Place your Program 
Diskette in a safe place, and use the backup as your main copy. 
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■ Chapter 4: INSTALLATION 

If you do not have a Commodore 1581 or a CMD storage device, you may skip this chapter 
and move on to Chapter 5. If you are installing the Compression Kit (CKit) for the first time, 
follow the installation instructions very closely. If you are a seasoned pro, just remember these 
two basic rules: 

1. Copy all of the files from the Program Diskette to your new CKit disk and/or partition. 

2. Make sure thatyou copy the CKit files to the ROOT directory in CMD Native partitions, 
or the ROOT partition on 1581 formatted disks (or 1581 Emulation partitions). 

Commodore 1581 Installation: 

1. Place the Security Key into joystick port #1. 

2. Insert the Program Diskette into the disk drive. 

3. Boot up the CKit by typing: 

Commodore DOS 

LOAD"0:,[n],1 [return] 

JifTyDOS 


%0:* [return] 
or [shift][stop] 

Where [ n ] is the device number of the disk drive. Once the CKit has loaded, use the cursor 
keys to select the Filemaster, then press [ return ]. 

4. You are now in the Drive Selector. The green light bar should be highlighting the word 
"Drive” in the section labeled Source. Tap the [return] key until the device [n] which you 
booted the CKit from appears next to the word "Drive". 

5. Insert a blank 1581 formatted 3.5" DS/DD disk into your Commodore 1581 disk drive. 

6. Move the light bar to the word "Drive" in the section labeled Destination. Tap the 
[return] key until the CKit chooses your 1581, and places the correct information next to 
the word "Drive". 
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INSTALLATION 


7. The following instructions will copy all of the files from the Program Diskette to the 
Destination (in the fewest number of steps possible): 

A. Press [FI] to boot the Filemaster. 

B. Press [ return ] to select Copy Files. 

C. Press [ t ] to select all of the files on the Program Diskette. 

D. Press [FI] to begin job. 

E. Press [y] to confirm. 

F. Wait for job to finish. 

G. Press [return] to acknowledge "Job Complete [return]". 

H. Press [«-] to leave the Filemaster. 

I. Press [«-] to exit the drive selector. 

J. Move light bar down to Quit using the cursor keys, then press [ return ]. 

K. Put the Program Diskette away in a safe place. 

L. Boot the CKit from the new copy. 

CMD Floppy Drive Installation (1581 Mode) 

1. Follow steps (1) through (4) above in Commodore 1581 Installation. 

2. Insert a blank True 1581 formatted 3.5" DS/DD disk into your CMD Floppy Drive. 

3. Move the light bar to the word "Drive" in the section labeled Destination. Tap the 
[return] key until the CKit chooses your FD, and places the correct information next to the 
word "Drive". 

4. Move the light bar down one position to the word "Part". Press the [ return ] key. 

The label "(1581)" should appear at the end of "CMD Floppy Drive", indicating that the FD 
is in 1581 Mode. 

5. Go to step (7) above in Commodore 1581 Installation. 

CMD Floppy Drive Installation (Partitionable Mode) 

1. Using the utility FD-TOOLS that came with your CMD Floppy Drive, create a Native 
partition with a recommended size of (768) blocks. The CKit will work perfectly in 
1541/1571/1581 Emulation partitions, but it performs at optimum , speed in Native partitions. 

2. After creating the new partition, exit FD-TOOLS, and follow steps (1) through (4) above 
in Commodore 1581 Installation. 
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INSTALLATION 


3. Insert the CMD formatted disk (with your Destination CKit partition already created) into 
your FD. 

4. Move the light bar to the word "Drive" in the section labeled Destination. Tap the 
[ return ] key until the CKit chooses your FD, and places the correct information next to the 
word "Drive". 

5. Move the light bar down one position to the word "Part". Tap the [return) key until 
the partition that you created appears next to the word "Part”. 

6. Go to step (7) above in Commodore 1581 installation. 

CMD Hard Drive Installation 

1. Using the utility HD-TOOLS that came with your CMD Hard Drive, create a Native 
partition with a recommended size of (768) blocks. The CKit will work perfectly in 
1541/1571/1581 Emulation partitions, but it performs at optimum speed in Native partitions. 

2. After creating the new partition, exit HD-TOOLS, and follow steps (1) through (4) above 
in Commodore 1581 Installation. 

3. Move the light bar to the word "Drive" in the section labeled Destination. Tap the 
[return] key until the CKit chooses your HD, and places the correct information next to the 
word "Drive". 

4. Move the light bar down one position to the word "Part". Tap the [ return ] key until 
the partition that you created appears next to the word "Part". 

5. Go to step (7) above in Commodore 1581 Installation. 

CMD RAMLink/RAMDrive Installation 

1. Using the utility RAM-TOOLS that came with your CMD RAMLink/RAMDrive, create 
a Native partition with a recommended size of (768) blocks. The CKit will work perfectly in 
1541/1571/1581 Emulation partitions, but it performs at optimum speed in Native partitions. 

2. After creating the new partition, exit RAM-TOOLS, and follow steps (1) through (4) above 
in Commodore 1581 Installation. 

3. Move the light bar to the word "Drive" in the section labeled Destination. Tap the 
[return] key. until the CKit chooses your RAMLink/RAMDrive, and places the correct 
information next to the word "Drive". 
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INSTALLATION 

4. Move the light bar down one position to the word "Part". Tap the [ return ] key until 
the partition that you created appears next to the word "Part". 

5. Go to step (7) above in Commodore 1581 Installation. 
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■ Chapter 5: HOW TO USE THIS MANUAL 

The Compression Kit (CKit) is completely menu driven. Using the menus, you should be able 
to find your way around the utilities included with your CKit. So reading the entire User’s 
Manual is not necessary. However, Mad Man Software recommends that you read Chapters 
1 through 6 and Chapter 12. These chapters will provide all the information that you need to 
get started. 

When problems or questions do arise, consult the appropriate chapter in this User’s Manual. 
Each utility has its own chapter with detailed step by step instructions and several helpful 
examples. In most cases, you can find the information that you need by referring to only one 
chapter. 

Should you run into a technical problem that the User’s Manual can not help you with, you 
can call Mad Man Software’s user support line at (307) 632-1178. 
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■ Chapter 6: SERVER & DRIVE SELECTOR 

Booting Up 

Before booting up the Compression Kit (CKit), make sure that you plug the Security Key into 
joystick port #1. To boot the CKit, insert the Program Diskette and/or switch to the partition 
which you created in Chapter 4. Then, issue the command: 

Commodore DOS 

LOAD"0:*",[n],1 [return] 

JiffyDOS 

%0:* [return] 
or [shift][stop] 

Where [n] is the appropriate device number. The CKit will then automatically boot itself. 

Security Key Check 

The first action the CKit does after booting is check for the Security Key. If the Security Key 
is not present, the CKit will remind you, and give you a chance to plug in the key. 

Server 

Once you are past the Security Key check, the CKit will enter the Server. The Server’s Main 
Menu has eight (8) options: 


DtAIN-lVIENli^K 

DESCRIPTION ^ - ' •• " 

Filemaster 

Full featured fast file copier 

Procopy 

All purpose disk and partition copier 

Archiver 

Powerful file backup utility with compression 

1541 Disk Boa 

Whole disk compressor (compresses 1541 disks) 

1571 Disk Boa 

Whole disk compressor (compresses 1571 disks) 

1581 Disk boa 

Whole disk compressor (compresses 1581 disks) 

CMD Native Boa 

Native partition compressor (for CMD devices) 

Quit 

Exits the CKit into Commodore BASIC V2.0 
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SERVER & DRIVE SELECTOR 


The Main Menu has a green light bar. Use the cursor keys to move the light bar to the 
various options (use of the [ shift ] key is unnecessaiy). Notice that the section labeled 
"Description" to the right of the menu, contains a brief description of the option currently 
highlighted by the light bar. To select a utility, move the light bar to the utility that you wish 
to use, then press [ return ]. 

If you select the utility Procopy, you will be asked for a Copy Type: 




1541 Disk/Part 

Copy a 5.25" SS/DD 1541 Disk or Emulation Partition 

1571 Disk/Part 

Copy a 5.25" DS/DD 1571 Disk or Emulation Partition 

1581 Disk/Part 

Copy a 3.5" DS/DD 1581 Disk or Emulation Partition 

CMD Native Part 

Copy a entire CMD Native Partition 

Abort 

Return to the Main Menu 


Use the light bar to select the type of copy that you wish to make, then press [return]. 
Abort will return you to the Main Menu. 

If you select one of the Boas, you will be asked for a Boa Type: 



•vivXy- • y.y:>v * • -x .. .$ •$/. %:• "V s ,:*:• >'--.7.V \' | 

Compress 

Compress a disk or partition into CKit files | 

Decompress 

Decompress a disk or partition from CKit files | 

Abort 

Return to the Main Menu | 


Use the light bar to select the type of Boa that you wish to use, then press [return]. 
Compress allows you to compress disks or partitions into manageable CKit files. Decompress 
allows you to restore disks or partitions from those CKit files. Abort will return you to the 
Main Menu. 

If you select Quit, the Server will exit into BASIC. In the case of an accidental exit, use the 
Server's SYS4 safety feature. To re-enter the Server type: 

SYS4 [return] 
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SERVER & DRIVE SELECTOR 


You can issue DOS commands and safely return to the Server with no problems. But once 
you begin to run other programs and the like, DO NOT RELY ON THE SYS4 FEATURE. 

Drive Selector 

Once you select a utility, the Server will send you to the Drive Selector. The Drive Selector 
allows you to choose your Source and Destination setups (drives, partitions, and paths). The 
CKit supports single drive setups as well as multiple drive setups. 

There are three main sections to the Drive Selector. The first section is titled the Source and 
the second section is titled the Destination. Both of these sections are accessed by using the 
green light bar. The third section lies at the bottom of the screen and contains a short list of 
keystroke commands. 

Setting The Source 


NOTE: The Drive Selector will not allow you to choose drives, partitions, or paths which 
conflict with the utility. For example, if you select the 1581 Disk Boa on Compress, the 
Drive Selector will not allow you to choose a Commodore 1541 as the Source drive. 


The green light bar along with the cursor and [return] keys are used to select the Source 
drive, partition, and path. 

To select the Source drive, place the light bar on the word "Drive" and tap the [return] key 
until you see the device that you want 

The Drive Selector will look for device numbers (8) through (29) in ascending order as you 
tap the [return] key. If you tap [shift] [return], the Drive Selector will look for the 
same device numbers in descending order. This [shift] rule applies on several options 
found throughout the CKit 
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SERVER & DRIVE SELECTOR 


To select the Source partition (CMD devices only), place the light bar on the word "Part" and 
tap the [ return ] key until you see the partition that you want. If you wish to go back to a 
previous partition, tap [shift] [return]. The CKit looks for partitions (1) through (254) 
on CMD Hard Drives and partitions (1) through (31) on CMD RAMLinks, RAMDrives, and 
Floppy Drives. 


CMD Hard Drive Users: Be careful with the select partition command. If you only have 
a few partitions and go past the last one, the CKit may take a few seconds before it wraps 
back around to the next available partition. 


CMD Floppy Drive Users: The partition command will interrogate the disk currently 
inside your FD. If the disk is in a CMD partitionable format, the partition commands will 
work as explained above. But if the disk is a True 1581 formatted Disk, the CKit will 
place the FD into 1581 Mode. 


To select the Source path (Commodore 1581’s and CMD devices), place the light bar on the 
word "Path" and press [return]. If you are using a Commodore 1581, a CMD Floppy Drive 
in 1581 Mode, or a CMD device with a Native partition selected; the CKit will allow you to 
type in a path. 

The CKit uses the same syntax as the CMD DOS paths. For example, if you must issue the 
following command to enter into a nested subdirectoiy: 

Commodore DOS 

OPEN15,12,15:PRINT#15,"CD//GAMES/ACTION/MONKEYS":CLOSE15 [return] 
JifTyDOS 

eCD//GAMES/ACTION/MONKEYS [return] 

Type in only the path name, and leave the extras out: 

//games/action/monkeys/ 

If you are using a Commodore 1581 or are in a 1581 Emulation partition, use the exact same 
syntax (as described above). For example, if you must normally issue the following commands 
to enter into a nested partition: 
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SERVER & DRIVE SELECTOR 


Commodore DOS 

OPEN15,10,15:PRINT#15,"/":CLOSE15 [return] 

OPEN15,10,15:PRINT#15,"/0:LIBRARY":CLOSE15 [return] 

OPEN15,10,15:PRINT#15,"/0:GRAPHICS":CLOSE15 [return] 

OPEN15,10,15:PRINT#15,“/0:PICTURES":CLOSE15 [return] 

JiffyDOS 

@/ [return] 

0/0:LIBRARY [return] 

0/0:GRAPHICS [return] 

6/0:PICTURES [return] 

Just use the following syntax, and the CKit will do all of that work for you: 

//library/graphics/pictures/ 

Be aware that the CKit has a forty (40) character path limit. Should your path length be 
greater than forty (40) characters, you will have to reduce its length through the use of the 
Commodore wild card character For example, you could use the path: 

//coll*/eng*/pap*/ 

In the place of: 

//college/english/papers/ 

After you finish typing in the path, press [return]. The CKit will attempt to select that 
path. If an error occurs, you will get the standard DOS "FILE NOT FOUND" error, and the 
CKit will clear the path. 


Setting The Destination 


The process for selecting the Destination drive, partition, and path is identical to the Source. 
Should you have questions, refer to Setting The Source above. 


Special Case: If you selected 1581 Procopy or the 1581 Disk Boa on Decompress AND 
have a CMD Floppy Drive as your Destination drive; when you use the select partition 
command, if the CKit can not recognize the format of the disk in the FD (or no disk is 
present) the FD will default to 1581 Mode. This was done so that you may copy or 
restore 1581 disks on your FD without having to pre-format the Destination disks. 
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SERVER & DRIVE SELECTOR 


Drive Selector Commands 


NOTE: The CKit will not allow you to use certain commands until the Source and/or 
Destination is setup correctly. The CKit will not display an error, it will just ignore the 
illegal keystrokes. 


[FI] Boot 

Once you have your Source and Destination setups in order, you may press the [FI] key to 
begin booting the utility that you selected. The current utility name should be listed to the 
right of the word "Boot" in the menu area. If you are using a disk drive, you may have to 
insert the Program Diskette, so that the CKit can access its data files. The CKit will inform 
you if it needs the Program Diskette. In this case, just follow the instructions on the screen. 

[*■] Abort 

This key will return you to the Server. 

[a][b] Directory 

When selected, this command will display the directory of [a] the Source or [b] the 
Destination. If you are fortunate enough to have a Real Time Clock (RTC) on your CMD 
device, the CKit will display a time and date stamped directory listing. Pressing [control ] 
will either pause or slow the listing depending on your computer. You may press [ stop ] at 
any time, to stop reading the directory. When viewing a directory you can use the 
[ shift ] [ commodore ] key combination to toggle between upper and lower case text modes. 
After the directory listing is complete or has stopped, press [return] to return to the Drive 
Selector. 

[1] [2] DOS Command 

This command will allow you to send a DOS command to [1] the Source or [2] the 
Destination. Upon selecting this command, the CKit switches to the DOS Command screen. 
To issue a command, type in the desired command using the standard DOS syntax, then press 
[return]. Press [«-] the abort key if you wish to return to the Drive Selector. 
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SERVER & DRIVE SELECTOR 


NOTE: The CKit will send the DOS command to the exact partition and path that you 
specified in [ 1 ] the Source or [ 2 ] the Destination. 


After the drive finishes the DOS command, the CKit will display the error message on the 
command channel. Press [ return ] to return to the Drive Selector. 
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■ Chapter 7: FILEMASTER 

The Filemaster is a full featured file copier. It will copy standard Commodore PRG, SEQ, and 
USR files. What makes the Filemaster different from other file copiers, is that it contains 
strong error recovery features and includes a full verify. 


GEOS Users: Avoid using the Filemaster on GEOS disks and partitions. If you need to 
copy your GEOS data use the utility Procopy (please refer to Chapter 8). 


Using The Filernaster 

There are three basic steps you must take whenever you use the Filemaster: 

1. Select the job (copy, move, or delete files). 

2. Select the files for the job. 

3. Monitor the job. 

Each step has its own screen. The following text details each step in this process. 

1. Select Job (Screen) 

When you first enter the Filemaster from the Drive Selector you are given a short list of 
possible jobs: 


Mmwm m 

iHHI HNHI 

Copy Files 

Copies files from the Source to the Destination 

| Move Files 

Moves files from the Source to the Destination 

| Delete Files 

Deletes files from the Source 


Before you select a job, INSERT YOUR SOURCE AND DESTINATION DISKS (IF YOU 
ARE ONLY USING ONE DRIVE, INSERT YOUR SOURCE DISK). To select a job, use 
the cursor keys to highlight the job that you want with the green light bar, then press 
[return]. Press [«-] the abort key to return to the Drive Selector. 
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FILEMASTER 


Select Drive Mode (Copy Flies and Move Files) 

If the Source and Destination drives are defined as the same Commodore 1581 or CMD 
Floppy Drive, then the Select Drive Mode menu will appear on the screen. If the Source and 
Destination partitions (and/or paths) are on the SAME disk, select [ 1 ] Single Disk. If the 
Source and Destination partitions (and/or paths) are on SEPARATE disks, select [ 2 ] Disk 
To Disk. If you wish to return to the Select Job (Screen), press [«-] the abort key. 


Special Case; If the Source and Destination drives are defined as the same CMD Floppy 
Drive AND the Source is in a different mode than the Destination, then the Filemaster 
will automatically skip this menu. For example, if the Source is in 1581 Mode and the 
Destination is in CMD Partitionable Mode then the Filemaster would skip this menu. 


Once you select an option, the Filemaster will scan the Source directory for the first (255) 
valid files. If there are no valid files available, the Filemaster will display a brief error 
message, and return you to the Select Job (Screen). If the Filemaster finds any valid files, it 
will switch to the Select Files (Screen). 


NOTE: The Filemaster will only work with properly closed PRG, SEQ, and USR files. 
In order to be copied correctly, USR files must use standard Commodore sector chaining. 
The Filemaster will not copy REL files. 


2. Select Files (Screen) 

There are three important areas on this screen. At the top is the status area. The status area 
informs you of the number of selected files and blocks, the verify status, and the current copy 
mode. The large window directly beneath the status area, is the file list. Off to the right of 
the file list is a brief list of keystroke commands. 

To scroll through the file list, use the cursor keys. Markers are used at the top and bottom 
of the file list window. These markers indicate whether or not you have reached the top or 
bottom of the file list. If you press the [ return ] key, the Filemaster will select the file that 
is currently highlighted by the light bar, and move the light bar down one position. Selected 
files are highlighted in RED, and unselected files are highlighted in WHITE. The Filemaster 
allows up to (191) files to be selected. 

[FI] Begin Job 

After you finish selecting the files for a job, use this command to move on to the Job (Screen). 
If no files are selected the Filemaster will ignore this command. 
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FILEMASTER 


It] Toggle 

This command allows you to select all of the files possible (up to 191) with a single keystroke. 
If you have already selected all of the files possible, this command will deselect all of the files. 


NOTE: This toggle command works differently than most file copiers. The command 
either selects all of the files, or deselects all of the files. There is no in between. 


[vj Verify 

This command allows you to turn the verify feature ON and OFF. The current status of the 
feature can be found next to the word ''Verify" in the status area. When the verify feature is 
ON, the Filemaster verifies each file for integrity after it is copied. When moving files, the 
Filemaster verifies the file on the Destination before it scratches it from the Source. Mad Man 
Software recommends that you leave the verify feature ON, especially when using the Move 
Files option. 

[m] Mode 

This command selects one of the following copy modes available: 



DESCRIPTION^.,;.^ V'.- v ; r ?%' 

ASK 

Upon each occurrence, asks if you wish to replace the file 

REPLACE 

Replaces files which have the same filename 

SKIP 

Skips files that already exist 


The current copy mode is listed next to the word "Mode" in the status area. The mode tells 
the Filemaster how to deal with files that already exist on the Destination with the same 
filename. 

[«*J Abort 

This key returns you to the Select Job (Screen). 
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FILEMASTER 


Non-Listed Commands 

[home] (move light bar to the top entiy in the file list) 

[shift] [home] (move light bar to the last entry in the file list) 

[shift] [return] (select file and move the light bar up one position) 

3. Job (Screen) 

The Job (Screen) has three main sections. The top section is labeled Job. The job you 
selected (Copy Files, Move Files, or Delete Files) appears in this section. The middle section 
labeled Status, is used to keep track of the current job in progress. And the bottom section 
labeled Buffer, helps you monitor the job’s use of memory. 

The most important section on the Job (Screen) is the status area. All of the user prompts 
and messages are placed here. The first message you will see is, "Begin Job - Are you sure 
(y/n)?" If you select [ n ] no, the Filemaster will return you to the Select Files (Screen). If you 
select [y] yes, then the Filemaster will begin the job. 

Once the job begins, you always have the option of canceling the job by holding down the 
[stop] key. Should the Filemaster run into any problems or need to swap disks, it will 
inform you in the status area. Follow the instructions and prompts which appear in this area 
until the job is complete. If you run into any serious problems, please refer to Chapter 12. 


IMPORTANT: The Filemaster has no way of knowing how much disk space is available 
on your Destination. If the Filemaster runs out of disk space, it will ABORT the job. 
Therefore, you must always pre-check your Destination (partition or disk) for adequate 
disk space before beginning a job._ 


Below is a moderately detailed description of how the Filemaster will process each of its three 
possible jobs (for advanced users only). If you watch the status and buffer areas carefully, you 
will be able to follow a job process as it happens. 

Copy Files Process: 

A. Clear the buffer 

B. Ask for Source disk 

C. Initialize the Source 

D. Read selected files (until finished or buffer is full) 

E. Ask for Destination disk 

F. Initialize the Destination 

G. Write out next file (until finished or buffer is empty) 
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FILEMASTER 


H. If file is finished 

Verify the file 
If there are more files 
Goto (G) 

Else (job is complete) 

Done 

Else (buffer is empty) 

Goto" (A) 

Move Files Process: 

A. Clear the buffer 

B. Ask for Source disk 

C. Initialize the Source 

D. Read selected files (until finished or buffer is full) 

E. Ask for Destination disk 

F. Initialize the Destination 

G. Write out next file (until finished or buffer is empty) 

H. If file is finished 

Verify the file 

Scratch the file from the Source 
If there are more files 
Goto (G) 

Else (job is complete) 

Done 

Else (buffer is empty) 

Goto (A) 

Delete Files Process: 

A. Initialize the Source 

B. Scratch next selected file 

C. If DOS error occurs 

Show DOS error 
Quit 

Else if there are more files 
Goto (B) 

Else (job is complete) 

Done 
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■ Chapter 8: PROCOPY 

Procopy is a reliable fast disk and partition copier. It copies standard Commodore disks and 
CMD partitions, track by track, sector by sector. Procopy also includes the Compression Kit’s 
(CKit) full verify options and strong error recoveiy features. Use Procopy when you need to 
make a WORKING backup of a disk or partition, otherwise use one of the CKit Boas that 
feature compression (please refer to Chapters 10 and 11). 


| NOTE: Procopy can not copy write protected disks. _ 

Using Procopy 

There are two steps you must take whenever you use Procopy. 

1. Select options (begin job and verify). 

2. Monitor the job. 

Each step has its own screen. 

1. Options (Screen) 

When you first enter Procopy from the Drive Selector you are given two options: 


OPTIONS 

DESCRIPTION 

Begin Job 

Moves on to the Job (Screen) 

Verify 

Toggles the verify feature ON and OFF 


Before you select anything, INSERT YOUR SOURCE AND DESTINATION DISKS (IF 
YOU ARE USING ONLY ONE DRIVE INSERT YOUR SOURCE DISK). 

To select a option, use the cursor keys to highlight the option that you want with the green 
light bar, then press [return]. Press [«-] the abort key to return to the Drive Selector. 

When the verify feature is toggled ON, Procopy verifies each bit of data that it copies. Mad 
Man Software highly recommends that you leave the verify feature ON. 

To begin copying place the light bar on Begin Job, then press [return]. 
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PROCOPY 


Select Drive Mode (CMD Floppy Drive) 

If the Source and Destination drives are defined as the same CMD Floppy Drive, then the 
Select Drive Mode menu will appear on the screen. If the Source and Destination partitions 
are on the SAME disk, select [ 1 ] Single Disk. If the Source and Destination partitions are 
on SEPARATE disks, select [ 2 ] Disk To Disk. If you wish to return to the Options (Screen), 
press [«-] the abort key. 


Special Case: If the Source and Destination drives are defined as the same CMD Floppy 
Drive AND the Source or the Destination is in 1581 Mode, then Procopy will 
automatically skip this menu. For example, if the Source is in 1581 Mode and the 
Destination is in CMD Partitionable Mode then Procopy would skip this menu. 


2. Job (Screen) 

The Job (Screen) has three main sections. The top section is labeled Job. The Copy Type you 
selected in the Server appears in this section: 


COFYlTYPE 



Copy 1541 5.25" SS/DD Disk 
Copy 1571 5.25" DS/DD Disk 
Copy 1581 3.5" DS/DD Disk 


Copy CMD Native Partition 


ili 


The middle section labeled Status, is used to keep track of the current job in progress. And 
the bottom section labeled Buffer, helps you monitor the job’s use of memory. 

The most important section on the Job (Screen) is the status area. All of the user prompts 
and messages are placed here. The first message you will see is, "Begin Job - Are you sure 
(y/n)?" If you select [n] no, Procopy will return you to the Options (Screen). If you select 
[y ] yes, then Procopy will begin the job. 

Once the job begins, you always have the option of canceling the job by holding down the 
[stop] key. Should Procopy run into any problems or need to swap disks, it will inform you 
in the status area. Follow the instructions and prompts which appear in this area until the job 
is complete. If you run into any serious problems, please refer to Chapter 12. 
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PROCOPY 


WARNING: All the data on your Destination disk or partition WILL BE DESTROYED 
when you use this utility. Therefore, take extra precautions before beginning a copy job. 


Below is a moderately detailed description of the copy process (for advanced users only). If 
you watch the status and buffer areas carefully, you will be able to follow the copy process as 
it happens. 

Copy Process: 

A. Clear the buffer 

B. Ask for Source disk 

C. Initialize the Source 

D. Read tracks (until disk finished or buffer is full) 

E. Ask for Destination disk 

F. Initialize the Destination 

G. Write next track (until finished or buffer is empty) 

H. If track is finished 

Verify the track 
If there are more tracks 
Goto (G) 

Else (job is complete) 

Done 

Else (buffer is empty) 

Goto (A) 
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■ Chapter 9: ARCHIVER 

The Archiver is a advanced file compression backup utility. It is designed to operate just like 
a file copier. If you know how to use the Filemaster, then you already know how to use most 
of the Archiver’s features. It is in this similarity between the two utilities that lies the true 
power of the Archiver. Of course, as with all of the Compression Kit’s (CKit) utilities, the 
Archiver sports strong error recovery features and built in verify options. 

You will find that the Archiver is quite fast and easy to use. 


GEOS Users: Avoid using the Archiver on GEOS disks and partitions. If you need to 
backup your GEOS data use the 1541/1571/1581 Disk and CMD Native Boas (please refer 
to Chapters 10 and 11). 


Archiver Extensions 

The Archiver uses a filename extension system to identify the compressed files that it creates. 
Each filename consists of sixteen (16) characters. The first twelve (12) characters are used for 
the name of the archive, and the last four (4) characters are used for the extension. Examples: 

"old letters ]ca " 

"basic games ]ca " 

"homework ]ca " 

The first two characters of the extension, "]c" indicates that the file was created using the 
CKit. The third character, "a" indicates that the file is an archive (a collection of PRG, SEQ, 
and USR files). There are times when the extension will have a fourth character. For 
example: 

"big archive ]caa" 

"huge archive]cad" 

This fourth character tells you two things. One, it tells you that the archive has data files. 
And two, it tells you how many data files that the archive has. Data files have the same name, 
but they have a "]c'" extension. The data files begin with "]c'a", then "]c'b", then 
"]c'c", and continue all the way up to "]c'z". You can tell how many data files that a 
archive has by the character which follows the " ]ca" extension. Study the examples below: 

"tiny archive]ca " (no data files) 

"big archive ]caa" (1 data file, "]c'a") 

"big archive ]c'a" 
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ARCHIVER 


"huge archivejcad" (4 data files, ”]c'a", "]c'b", "]c'c", and "]c'd") 
"huge archive]c'a" 

"huge archive]c'b" 

"huge archive]c'c" 

"huge archive]c'd" 

Using The Archiver 

Like the Filemaster, there are three basic steps you must take whenever you use the Archiver: 

1. Select the job (archive, dearchive, or examine). 

2. Select the files for the job. 

3. Monitor the job 

Each step has its own screen. The following text details each step in this process. 

1. Select Job (Screen) 

When you first enter the Archiver from the Drive Selector you are given a short list of possible 

jobs: 


OPTIONS^-^J 

IpesM 

Sl: 

II 

:• •: x: x : i £ 

Archive Files 

Compresses standard files into CKit archive files 

DeArchive Files 

Decompresses CKit archive files into standard files 

Examine Archive 

Views the contents of CKit archive files 


Before you select a job, INSERT YOUR SOURCE AND DESTINATION DISKS (IF YOU 
ARE USING ONLY ONE DRIVE INSERT YOUR SOURCE DISK). To select a job, use 
the cursor keys to highlight the job that you want with the green light bar, then press 
[return]. Press [«-] the abort key to return to the Drive Selector. 

Select Drive Mode (Archive Files and DeArchive Files) 

If the Source and Destination drives are defined as the same Commodore 1581 or CMD 
Floppy Drive, then the Select Drive Mode menu will appear on the screen. If the Source and 
Destination partitions (and/or paths) are on the SAME disk, select [ 1 ] Single Disk. If the 
Source and Destination partitions (and/or paths) are on SEPARATE disks, select [ 2 ] Disk 
To Disk. If you wish to return to the Select Job (Screen), press [«-] the abort key. 
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ARCHIVER 


Special Case: If the Source and Destination drives are defined as the same CMD Floppy 
Drive AND the Source is in a different mode than the Destination, then the Archiver will 
automatically skip this menu. For example, if the Source is in 1581 Mode and the 
Destination is in CMD Partitionable Mode then the Archiver would skip this menu. 


Archive Files 

Once you select the Archive Files option, the Archiver will scan the Source directory for the 
first (255) valid files. If there are no valid files available, the Archiver will display a brief error 
message, and return you to the Select Job (Screen). If the Archiver finds any valid files, it will 
switch to the Archive Select Files (Screen). 


NOTE: The Archiver will only work with properly closed PRG, SEQ, and USR files. In 
order to be compressed correctly, USR files must use standard Commodore sector 
chaining. If you wish to compress REL files use the 1541/1571/1581 Disk and CMD 
Native Boas (please refer to Chapters 10 and 11). 


2. Archive Select Files (Screen) 

There are three important areas on this screen. At the top is the status area. The status area 
informs you of the number of files and blocks selected, the verify status, and the maximum 
archive file size. The large window directly beneath the status area, is the file list. Off to the 
right of the file list is a brief list of keystroke commands. 

To scroll through the file list, use the cursor keys. Markers are used at the top and bottom 
of the file list window. These markers indicate whether or not you have reached the top or 
bottom of the file list. If you press the [return] key, the Archiver will select the file that 
is currently highlighted by the light bar, then move the light bar down one position. Selected 
files are highlighted in RED, and unselected files are highlighted in WHITE. The Archiver 
allows up to (170) files to be selected. 

[FI] Begin Job 

After you finish selecting the files to be compressed, use this command to move on to the Job 
(Screen). If no files are selected the Archiver will ignore this command. 

[t] Toggle 

This command allows you to select all of the files possible (up to 170) with a single keystroke. 
If you have already selected all of the files possible, this command will deselect all of the files. 


©1993 Mad Man Software, Inc. 


29 





archiver 


[v] Verify 

This command allows you to turn the verify feature ON and OFF. The current status of the 
feature can be found next to the word "Verify" in the status area. 

[1] Limit 

The limit feature allows you to select the maximum size of the data files that the Archiver 
generates. The current limit is listed next to the word "Limit" in the status area. The limits 
you may select are NONE, (100), (200), (300), and (400). 

If you select NONE, the Archiver will generate only one data file for the entire archive. If you 
select one of the limits, the Archiver will limit the sizes of the data files that it generates to 
that limit. For example, if the archive will consume (250) blocks and you select a limit of (100) 
blocks, then the Archiver will generate two (100) block data files and one (50) block data file 
(100 blocks + 100 blocks + 50 blocks = 250 blocks). Since an archive is limited to a 
maximum of (27) data files, once you select a limit, you are limiting the maximum size of the 
archive. If you are compressing more than (2,700) blocks worth of files, you should consult 
the table below. 


jpiirclil 

MAXIMUM ARCHIVE SIZE 

NONE 

Infinite 

100 

27 X 100 = 2,700 Blocks 

200 

27 x 200 = 5,400 Blocks 

300 

27 x 300 = 8,100 Blocks 

400 

27 x 400 = 10,800 Blocks 


[«-] Abort 

This key returns you to the Select Job (Screen). 

Non-Llsted Commands 

[home] (move light bar to the top entry in the file list) 

[shift] [home] (move light bar to the last entry in the file list) 
[shift] [return] (select file and move the light bar up one position) 
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3. Archive Job (Screen) 

The Archive Job (Screen) has three main sections. The top section labeled Job, lists the job 
you selected, "Archive Files". The middle section labeled Status, is used to keep track of the 
job. And the bottom section labeled Buffer, helps you monitor the job’s use of memory. 

The most important section on the Archive Job (Screen) is the status area. All of the user 
prompts and messages are placed here. The first message you will see is, "Enter archive name 
(12 ch’s)." Type in a filename for the archive, then press [return]. If you wish to go back 
to the Archive Select File (Screen), just press [return]. After you select an archive 
filename, the Archiver will ask you, "Begin Job - Are you sure (y/n)?" If you select [ n ] no, 
the Archiver will return you to the Archive Select Files (Screen). If you select [y ] yes, then 
the Archiver will begin the job. 

Once the job begins, you always have the option of canceling the job by holding down the 
[ stop] key. Should the Archiver run into any problems or need to swap disks, it will inform 
you in the status area. Follow the instructions and prompts which appear in this area until the 
job is complete. If you run into any serious problems, please refer to Chapter 12. 

If you selected a limit AND have selected a disk drive as your Destination device, the Archiver 
will give you a chance to swap disks after each data file that it generates. This allows you to 
create large archives on multiple floppy disks. 


IMPORTANT: The Archiver has no way of knowing how much disk space is available on 
your Destination. If the Archiver runs out of disk space, it will ABORT the job. 
Therefore, you must always pre-check your Destination (partition or disks) for adequate 
disk space before beginning a job. 


Below is a moderately detailed description of the archiving process (for advanced users only). 
If you watch the status and buffer areas carefully, you will be able to follow this process as it 
happens. 

Archive Files Process: 

A. Get the archive name 

B. Clear the buffer 

C. Ask for Source disk 

D. Initialize the Source 

E. Compress selected files (until finished, reached limit, or buffer is full) 

F. Ask for Destination Disk 

G. Initialize the Destination 
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H. Write out archive data file (until finished, or buffer is empty) 

I. If archive data file is finished 

If more files to compress 

Give user chance to swap Destination disk 
Goto (B) 

Else (archive is done) 

Rename first archive data file 
Verify each Source file in the archive 
Done 

Else (buffer is empty) 

Goto (B) 

DeArchive Files 

Once you select the DeArchive Files option, the Archiver will scan the Source directory for 
the first (255) valid files with the "]ca" extension. If there are no such files present, the 
Archiver will display a brief error message, and return you to the Select Job (Screen). If the 
Archiver finds any valid files, it will switch to the DeArchive Select Archive (Screen). 

MS-DOS Extensions 

The DeArchive Files option is equipped to handle CKit MS-DOS BBS ".ca" extensions. 
You may find files which use these extensions on certain Bulletin Board Services (BBS’s). See 
the table below: 


MS-DOS EXAMPLES 

COMMODORE EQVrVALEINTS 

"hackers.ca" 

"hackers 

]ca " 

"modem.ca" 

"modem 

]ca " 

"news.cac" 

"news 

] cac " 

"news.c'a" 

"news 

]c'a" 

"news.c'b" 

" news 

] c' b " 

"news.c'c" 

" news 

] C * C " 


The data in these ".ca" files is exactly the same as the data found in " ]ca" files. The only 
difference is in the way that they are named. In fact, you could just rename the " .ca" files 
to their Commodore equivalents and they would decompress fine. 
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2. DeArchive Select Archive (Screen) 

There are three important areas on this screen. At the top is the status area. The status area 
informs you of the verify status and the current copy mode. The large window directly beneath 
the status area, is the file list. Off to the right of the file list is a brief list of keystroke 
commands. 

To scroll through the file list, use the cursor keys. Markers are used at the top and bottom 
of the file list window. These markers indicate whether or not you have reached the top or 
bottom of the file list If you press the [ return ] key, the Archiver will select the file that 
is currently highlighted by the light bar and move on to the DeArchive Job (Screen). 

[v] Verify 

This command allows you to turn the verify feature ON and OFF. The current status of the 
feature can be found next to the word "Verify" in the status area. 

[m] Mode 

This command selects one of the following copy modes available: 


—f 

^DESCRIPTION : ^■■ 

ASK 

Upon each occurrence, asks if you wish to replace the file 

REPLACE 

Replaces files which have the same filename 

SKIP 

Skips files that already exist 


The current copy mode is listed next to the word "Mode" in the status area. The mode tells 
the Archiver how to deal with files that already exist on the Destination with the same 
filename. 

[«-] Abort 

This key returns you to the Select Job (Screen). 

Non-Listed Commands 

[ home ] (move light bar to the top entry in the file list) 

[shift] [home] (move light bar to the last entry in the file list) 
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3. DeArchive Job (Screen) 

The DeArchive Job (Screen) has three main sections. The top section is labeled Job. The job 
you selected (DeArchive) and the file you selected to DeArchive appears in this section. The 
middle section labeled Status, is used to keep track of the current job in progress. And the 
bottom section labeled Buffer, helps you monitor the job’s use of memory. 

The most important section on the DeArchive Job (Screen) is the status area. All of the user 
prompts and messages are placed here. The first message you will see is, "Begin Job - Are you 
sure (y/n)?" If you select [n] no, the Archiver will return you to the Select Files (Screen). 
If you select [ y ] yes, then the Archiver will begin the job. 

Before the Archiver begins decompressing files, it will warn you of the number of files and 
blocks that the archive will expand into. Press [return] to continue the job. Press [ stop] 
if you wish to cancel the job. 

As the Archiver is executing the job, keep in mind that you always have the option of canceling 
the job by holding down the [ stop ] key. Should the Archiver run into any problems or need 
to swap disks, it will inform you in the status area. Follow the instructions and prompts which 
appear in this area until the job is complete. If you run into any serious problems, please refer 
to Chapter 12. 

If the Archiver can not find a archive data file AND you have selected a disk drive as your 
Source device, the Archiver will give you a chance to swap Source disks. This allows you to 
decompress large archives whose data files are on multiple disks. 


IMPORTANT: The Archiver has no way of knowing how much disk space is available on 
your Destination. If the Archiver runs out of disk space, it will ABORT the job. 
Therefore, you must always pre-check your Destination (partition or disk) for adequate 
disk space before beginning a job. 


Below is a moderately detailed description of the dearchiving process (for advanced users 
only). If you watch the status and buffer areas carefully, you will be able to follow this process 
as it happens. 

DeArchive Files Process: 

A. Clear the buffer 

B. Ask for Source disk 

C. Initialize the Source 

D. Read the archive (until finished or buffer is full) 
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E. Ask for Destination disk 

F. Initialize the Destination 

G. Decompress next file (until file finished or buffer is empty) 

H. If file is finished 

Verify the file 
If there are more files 
Goto (G) 

Else (job is complete) 

Done 

Else (buffer is empty) 

Goto (A) 

Examine Archive 

This handy option allows you to view the contents of archives created by the CKit. Like the 
DeArchive Files option, the Examine Archive option can also understand archive files created 
by the MS-DOS BBS version of the CKit (please see the examples above under DeArchive 
Files). 

Once you select the Examine Archive option, the Archiver will scan the Source directory for 
the first (255) valid files with the " ]ca" extension. If there are no such files present, the 
Archiver will display a brief error message, and return you to the Select Job (Screen). If the 
Archiver finds any valid files, it will switch to the Examine Select Archive (Screen). 

2. Examine Select Archive (Screen) 

There are two basic areas on this screen. The large window on the left of the screen, is the 
file list. Off to the right of the file list is a short menu. 

To scroll through the file list, use the cursor keys. Markers are used at the top and bottom 
of the file list window. These markers indicate whether or not you have reached the top or 
bottom of the file list. If you press the [return] key, the Archiver will select the file that 
is currently highlighted by the light bar and move on to the Examine Archive (Screen). If you 
press [«-] the abort key, the Archiver will return you to the Select Job (Screen). 

Select the archive that you wish to examine and press [return]. 

Non-Listed Commands 

[home] (move light bar to the top entry in the file list) 

[shift] [home] (move light bar to the last entry in the file list) 


©1993 Mad Man Software, Inc. 


35 



ARCHIVER 


----- 

3. Examine Archive (Screen) 

After scanning the header (the beginning) of the archive’s first file, the Archiver switches to 
this screen. The format of the screen is just like the Examine Select Archive (Screen), except 
at the top of the file list window is a list of statistics for the archive: 




Name 

Name of the archive being examined 

Files 

Number of files in the archive 

Blocks 

Number of blocks that the archive expands into 

Ver 

Version of the CKit used to create the archive 


The file list window contains the list of files in the archive. Using the cursor keys you can 
scroll through each of the files and examine its name, number of blocks, and type (PRG, SEQ, 
or USR). The file list window on this screen uses the same markers as the Examine Select 
Archive (Screen), to indicate whether or not you have reached the top or bottom of the file 
list 

If you press [«-] the abort key, the Archiver will return you to the Examine Select Archive 
(Screen). 


n 
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■ Chapter 10: 1541/1571/1581 DISK BOAS 

These three utilities allow you to compress and decompress standard Commodore formatted 
disks or CMD Emulation partitions. The nickname ’Boa’ was chosen since boa constrictors 
squeeze their prey and likewise the Compression Kit (CKit) squeezes disks. Each Disk Boa 
works the same, so once you know how to use one of them, you know how to use all three of 
them. 



§§ 

y ' 


1541 Disk Boa 

Compresses Commodore 1541 5.25" SS/DD Disks and CMD 
1541 Emulation partitions into CKit Boa files 
(also decompresses) 

1571 Disk Boa 

Compresses Commodore 1571 5.25" DS/DD Disks and CMD 
1571 Emulation partitions into CKit Boa files 
(also decompresses) 

1581 Disk Boa 

Compresses Commodore 1581 3.5" DS/DD Disks and CMD 
1581 Emulation partitions into CKit Boa files 
(also decompresses) 


The Disk Boas compress entire disks (track by track and sector by sector) into convenient CKit 
Boa files. The Disk Boas also decompress CKit Boa files back into disks. Using the Disk 
Boas to backup your disks is more reliable than using standard disk copiers. CKit Boa files 
have the ability to know whether they are accurate or not. Backup disks do not have this 
ability. This is why Mad Man Software recommends that you backup your disks with the Disk 
Boas instead of Procopy. 


NOTE: The Disk Boas can not compress wri te protected disks. 

Disk Boa Extensions 


Like the Archiver, the Disk Boas use a filename extension system to identify the compressed 
files (boas) that they create. Each filename consists of sixteen (16) characters. The first twelve 
(12) characters are used for the name of the boa, and the last four (4) characters are used for 
the extension. Examples: 


"1541 

disk 

]c4 

”1571 

disk 

]c7 

"1581 

disk 

]c8 


©1993 Mad Man Software, Inc. 


37 






1541/1571/1581 DISK BOAS 


The first two characters of the extension, " ]c" indicates that the file was created using the 
CKit The third character a "4”, "7", or "8" indicates that the file is a compressed disk 
(1541, 1571, or 1581 disk). There are times when the extension will have a fourth character. 
For example: 


"half empty ]c4a" 

"full disk ]c7d" 

This fourth character tells you two things. One, it tells you that the boa has data files. And 
two, it tells you how many data files that the boa has. Data files have the same name, but they 
have a " ]c'" extension. The data files begin with " ]c 'a", then " ]c'b", then " ]c 'c", and 
continue all the way up to " ]c'z". You can tell how many data files that a boa has by the 
character which follows the " ]c4", " ]c7", or " ]c8" extension. Study the examples below: 


"empty disk ]c8 " (no data files) 


"half empty ]c4a" (1 data file, " ]c'a") 
"half empty ]c'a" 


"full disk 
"full disk 
"full disk 
"full disk 
"full disk 


]c7d" (4 data files, "]c'a", "]c'b", "]c'c", and "Ic'd") 
]c'a" 

]c'b" 

]c'c" 

Ic'd" 


Compress Disk 


Using The Disk Boa (Compress) 

There are two steps you must take whenever you use a Disk Boa to compress a disk. 

1. Select options (begin job, verify, limit, and swap). 

2. Monitor the job. 

Each step has its own screen. The following text details each step in this process. 
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1. Options (Screen) 

When you first enter a Disk Boa from the Drive Selector you are given four options: 


iiiiiHili 


Begin Job 

Moves on to the Job (Screen) 

Verify 

Toggles the verify feature ON and OFF 

Limit 

Sets the maximum boa data file size 

Swap 

When selected to ON allows you to swap Destination disks after the 
creation of each boa data file 


Before you select any of the options, INSERT YOUR SOURCE AND DESTINATION 
DISKS (IF YOU ARE USING ONLY ONE DRIVE INSERT YOUR SOURCE DISK). 

To select a option, use the cursor keys to highlight the option that you want with the green 
light bar, then press [return]. Press («-] the abort key to return to the Drive Selector. 

When the verify feature is toggled ON, the Disk Boa verifies each bit of data that it 
compresses. 

The limit feature allows you to select the maximum size of the data files that the Disk Boa 
generates. The limits you may select are NONE, (100), (200), (300), and (400). If you are 
using the 1581 Disk Boa the limits you may select are NONE, (200), (300), (400), and (500). 

If you select NONE, the Disk Boa will generate only one data file for the entire boa. If you 
select one of the limits, the Disk Boa will limit the sizes of the data files that it generates to 
that limit. For example, if the boa will consume (450) blocks and you select a limit of (200) 
blocks, then the Disk Boa will generate two (200) block data files and one (50) block data file 
(200 blocks + 200 blocks + 50 blocks = 450 blocks). 

The swap feature is only available if you select a limit AND your Destination device is a disk 
drive. If this feature is toggled ON, the Disk Boa will give you the opportunity to swap 
Destination disks after each data file is finished. This allows you to backup larger disks onto 
multiple smaller disks. For example, you could backup a 15813.5" DS/DD disk onto a couple 
of 1541 5.25" SS/DD disks. 

To begin compressing a disk place the light bar on Begin Job, then press [return]. 
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Select Drive Mode (CMD Floppy Drive) 

If the Source and Destination drives are defined as the same CMD Floppy Drive, then the 
Select Drive Mode menu will appear on the screen. If the Source and Destination partitions 
are on the SAME disk, select [1] Single Disk. If the Source and Destination partitions are on 
SEPARATE disks, select [2] Disk To Disk. If you wish to return to the Options (Screen), 
press [«-] the abort key. 


Special Case: If the Source and Destination drives are defined as the same CMD Floppy 
Drive AND the Source or the Destination is in 1581 Mode, then the Disk Boa will 
automatically skip this menu. For example, if the Source is in 1581 Mode and the 
Destination is in CMD Partitionable Mode then the Disk Boa would skip this menu. 


2. Job (Screen) 

The Job (Screen) has three main sections. The top section is labeled Job. The Disk Boa Type 
you selected in the Server appears in this section: 


mtstmojmYm 
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Compress 1541 5.25" SS/DD Disk 
Compress 1571 5.25" DS/DD Disk 
Compress 1581 3.5" DS/DD Disk 


The middle section labeled Status, is used to keep track of the job. And the bottom section 
labeled Buffer, helps you monitor the job’s use of memoiy. 

The most important section on the Job (Screen) is the status area. All of the user prompts 
and messages are placed here. The first message you will see is, "Enter boa name (12 ch’s)." 
Type in a filename for the boa, then press [return]. If you wish to go back to the Options 
(Screen), just press [ return ]. After you select a boa filename, the Disk Boa will ask you, 
"Begin Job - Are you sure (y/n)?" If you select [n] no, the Disk Boa will return you to the 
Options (Screen). If you select [y] yes, then the Disk Boa will begin the job. 

Once the job begins, you always have the option of canceling the job by holding down the 
[ stop] key. Should the Disk Boa run into any problems or need to swap disks, it will inform 
you in the status area. Follow the instructions and prompts which appear in this area until the 
job is complete. If you run into any serious problems, please refer to Chapter 12. 
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IMPORTANT: The Disk Boa has no way of knowing how much disk space is available on 
your Destination. If the Disk Boa runs out of disk space, it will ABORT the job. 
Therefore, you must always pre-check your Destination (partition or disks) for adequate 
disk space before beginning a job. 


Below is a moderately detailed description of the Compress Disk process (for advanced users 
only). If you watch the status and buffer areas carefully, you will be able to follow this process 
as it happens. 

Compress Disk Process: 

A. Get the boa name 

B. Clear the buffer 

C. Ask for Source disk 

D. Initialize the Source 

E. Compress tracks (until disk finished, reached limit, or buffer is full) 

F. Ask for Destination Disk 

G. Initialize the Destination 

H. Write out boa data file (until finished, or buffer is empty) 

I. If boa data file is finished 

If more tracks to compress 

Give user chance to swap Destination disk 
Goto (B) 

Else (boa is done) 

Rename first boa data file 
Verify each track in the boa files 
Done 

Else (buffer is empty) 

Goto (B) 

Decompress Disk 

Using The Disk Boa (Decompress) 


There are three basic steps you must take whenever you use a Disk Boa to decompress a disk: 

1. Select options (begin job and verify). 

2. Select the boa file for the job. 

3. Monitor the job. 

Each step has its own screen. The following text details each step in this process. 
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1. Options (Screen) 


When you first enter the Disk Boa from the Drive Selector you are given two options: 


•<OPTtONSl? 

: 'PESCRIPTIpN^;i ' 
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Begin Job 

Moves on to the Select Boa (Screen) 

Verify 

Toggles the verify feature ON and OFF 


Before you select a option, INSERT YOUR SOURCE AND DESTINATION DISKS (IF 
YOU ARE USING ONLY ONE DRIVE INSERT YOUR SOURCE DISK). 

To select a option, use the cursor keys to highlight the option that you want with the green 
light bar, then press [return]. Press [«*] the abort key to return to the Drive Selector. 

When the verify feature is toggled ON, the Disk Boa verifies each bit of data that it 
decompresses. Mad Man Software highly recommends that you leave the verify feature ON. 

To begin decompressing a disk place the light bar on Begin Job, then press [return]. 

Select Drive Mode (CMD Floppy Drive) 

If the Source and Destination drives are defined as the same CMD Floppy Drive, then the 
Select Drive Mode menu will appear on the screen. If the Source and Destination partitions 
are on the SAME disk, select [ 1 ] Single Disk. If the Source and Destination partitions are 
on SEPARATE disks, select [ 2 ] Disk To Disk. If you wish to return to the Options (Screen), 
press [<-] the abort key. 


Special Case: If the Source and Destination drives are defined as the same CMD Floppy 
Drive AND the Source or the Destination is in 1581 Mode, then the Disk Boa will 
automatically skip this menu. For example, if the Source is in 1581 Mode and the 
Destination is in CMD Partitionable Mode then the Disk Boa would skip this menu. 


Once you select the Begin Job option, the Disk Boa will scan the Source directory for the first 
(255) valid files with the appropriate " ]c4”, " ]c7", or " ]c8" boa extension. If there are 
no such files present, the Disk Boa will display a brief error message, and return you to the 
Options (Screen). If the Disk Boa finds any valid files, it will switch to the Select Boa 
(Screen). 
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MS-DOS Extensions 

The Disk Boa is equipped to handle CKit MS-DOS BBS ”.c4", ".c7", and ".c8" 
extensions. You may find files which use these extensions on certain Bulletin Board Services 
(BBS’s). See the table below: 


BliiiilliiiiH! 

COMMODORE EQUIVALENTS §§) 

"41utils.c4" 

"41utils 

]c4 " 

"sampler.c7" 

"sampler 

]c7 " 

"geosdata.c8c" 

"geosdata 

]c8c" 

"geosdata.c'a" 

"geosdata 

]c'a" 

"geosdata.c'b" 

"geosdata 

]c'b" 

"geosdata.c'c" 

"geosdata 

]c'c" 


The data in " .c4", " .c7", and " .c8" files is exactly the same as the data found in " ]c4", 
" ]c7", and " ]c8" files. The only difference is in the way that the files are named. In fact, 
you could just rename the " .c” files to their Commodore equivalents and they would 
decompress fine. 

2. Select Boa (Screen) 

The Select Boa (Screen) is composed of one large file list window. To scroll through the file 
list, use the cursor keys. Markers are used at the top and bottom of the file list window. 
These markers indicate whether or not you have reached the top or bottom of the file list. If 
you press the [return] key, the Disk Boa will select the file that is currently highlighted by 
the light bar and move on to the Job (Screen). If you press [<-] the abort key, the Disk Boa 
will return you to the Options (Screen). 

Select the boa file that you wish to decompress and press [ return ]. 

Non-Listed Commands 

[home] (move light bar to the top entry in the file list) 

[shift] [home] (move light bar to the last entry in the file list) 
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3. Job (Screen) 

The Job (Screen) has three main sections. The top section is labeled Job. The boa file you 
selected appears in this section following the word "Decompress". The middle section labeled 
Status, is used to keep track of the current job in progress. And the bottom section labeled 
Buffer, helps you monitor the job’s use of memory. 

The most important section on the Job (Screen) is the status area. All of the user prompts 
and messages are placed here. The first message you will see is, "Begin Job - Are you sure 
(y/n)?" If you select [n] no, the Disk Boa will return you to the Select Boa (Screen). If you 
select [y] yes, then the Disk Boa will begin the job. 

Once the job begins, you always have the option of canceling the job by holding down the 
[ stop] key. Should the Disk Boa run into any problems or need to swap disks, it will inform 
you in the status area. Follow the instructions and prompts which appear in this area until the 
job is complete. If you run into any serious problems, please refer to Chapter 12. 

If the Disk Boa can not find a boa data file AND you have selected a disk drive as your 
Source device, the Disk Boa will give you a chance to swap Source disks. This allows you to 
decompress large boas whose data files are on multiple disks. 


WARNING: All the data on your Destination disk or partition WILL BE DESTROYED 
when you use this utility. Therefore, take extra precautions before beginning a 
decompress job. _ 


Below is a moderately detailed description of the Decompress Disk process (for advanced users 
only). If you watch the status and buffer areas carefully, you will be able to follow this process 
as it happens. 
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Decompress Disk Process: 

A. Clear the buffer 

B. Ask for Source disk 

C. Initialize the Source 

D. Read the boa file (until finished or buffer is full) 

E. Ask for Destination disk 

F. Initialize the Destination 

G. Decompress next track (until track finished or buffer is empty) 

H. If track is finished 

Verify the track 
If there are more tracks 
Goto (G) 

Else (job is complete) 

Done 

Else (buffer is empty) 

Goto (A) 
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■ Chapter 11: CMD NATIVE BOA 

The Native Boa allows you to compress and decompress CMD Native partitions of any size. 
With this utility you can backup your Native partitions onto multiple floppy disks or separate 
partitions. The Native Boa operates just like the 1541/1571/1581 Disk Boas in Chapter 10 with 
the following three exceptions: 

1. Native Boa Extensions 

The Native Boa has its own extension system to identify the compressed files (boas) that it 
creates. Each filename consists of sixteen (16) characters. The first twelve (12) characters are 
used for the name of the boa, and the last four (4) characters are used for the extension. 
Examples: 

"basic utils ]cmd" 

"text editorsjcmd" 

"games Jcmd" 

The extension " Jcmd" indicates that the file is a compressed CMD Native partition. This 
extension also indicates that the file is the root file (first file) of the boa. Should the boa have 
data files, the data files will retain the same boa name but will have a number for its extension. 
For example: 

"ham project Jcmd” 

"ham project J001" 

"ham project J002" 

"ham project J003" 

"font backupsJcmd" 

"font backups]001" 

A large boa may have up to (999) data files. There should never be a situation where (999) 
data files are needed. Although the Native Boa will allow you to create a boa with hundreds 
of data files, Mad Man Software recommends that you keep the number of data files down to 
a manageable level by selecting larger data file limits. 

2. Limit (Compress Partition) 

The limits you may select are (NONE), (100), (200), (300),..., (1000). Do not select a limit 
which is larger than your Destination disk or partition size. Please refer to the chart below 
for Mad Man Software’s suggested limits. 
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CMD NATIVE BOA 
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1541 5.25" SS/DD Disk 

200 

3 

1571 5.25" DS/DD Disk 

300 

4 

1581 3.5" DS/DD Disk 

500 

6 


For the larger Native partitions, the total number of data files may surprise you. If the 
partition is mostly empty you may end up with one small file for the entire partition. But, if 
the partition is filled with information you may have a major backup job on your hands. 



llitiilli§f 

NUMBER OF DATA FILES ||| 

§ipi|J 

MB 

IBfHi! 


^BiS88 

i|MIT;|(Mw| 

i 

256 

2 

1 

i 

1 

5 

1,280 

7 

5 

3 

2 

10 

2,560 

13 

9 

6 

3 

50 

12,800 

64 

43 

26 

13 

o 

o 

rH 

25,600 

128 

86 

52 

26 

[255 
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3. Expansion Warning (Decompress Partition) 


The Native Boa will warn you before it begins decompressing, of the number of tracks and 
blocks that the boa will require (for successful decompression). Make sure that the 
Destination partition is large enough for the boa. The Native Boa will allow you to 
decompress a larger partition onto a smaller one but YOU MAY LOSE DATA IN THIS 
PROCESS. 


NOTE: If you need more help or information please refer to the 1541/1571/1581 Boas in 
Chapter 10. 
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■ Chapter 12: TROUBLE SHOOTING 

Due to the unpredictable nature of disk access, the Compression Kit (CKit) is designed to 
handle several different types of errors. This chapter focuses on how to take advantage of the 
CKit’s error handling abilities. Often times you can successfully deal with an error without 
having to abort the job. 

Bad Sectors 

There are times when the CKit drive routines will have trouble reading or writing a certain 
sector. The causes could be: 

□ Disk is not in drive 

□ Write protect tab is ON (for sector writes) 

□ Drive door is open 

□ Disk is physically damaged 

□ Sector is corrupted 

□ Sector is illegal (out of range) 

□ Drive head is dirty 

□ Drive is out of alignment 

As long as the sector is not illegal, try using the following process to recover a bad sector: 


BAD SECTOK RECOVERY PROCESS -- gjggg 


1. Remove disk from the drive (skip this step on CMD Hard Drives). 

2. Turn the drive off. 

3. Wait five seconds or so. 

4. Turn the drive back on. 

5. Place the disk back into the drive (skip this step on CMD Hard Drives). 

6. Use the try again option. _ 


The above process usually works quite well for recovering sketchy sectors, but you should not 
rely upon it. You can not use this process on CMD RAMLinks and RAMDrives. 

Fatal Errors 

If the CKit runs into a error from which it can not recover, it will perform a cold start reset 
and place you in the Fatal Error screen. The most common causes of Fatal Errors are: 

□ Active drive is turned off (or not present) 

□ A serial cable is loose or defected 

□ Another device on the serial bus has the same device number 

□ A system serial bus communication error has occurred 2 
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TROUBLE SHOOTING 


If a fatal error occurs, follow the instructions on the screen, then press [ return ]. The CKit 
will return you to the Main Menu in the Server. 

Serial Bus Problems 

If your drive light stays on, the drive just keeps spinning, or the job seems to be stuck; you 
have probably encountered a serial bus problem. The CKit uses fast serial bus communication 
and can be quite sensitive at times. Here is the procedure for dealing with a serial bus 
problem: 


/SERIAL BUS RECOVERY PROCESS 


w 



1. Try using the Bad Sector Recovery Process FIRST. 

2. Try to regain control of the CKit by using the cancel job key [ stop]. 

3. If [stop] does not work, try using the [stop] [restore] key combination. 

4. Whether you regain control of the CKit or not, reset the culprit drive. 


If this process does not work, you should turn OFF all of the devices on the serial bus then 
turn them all back ON. This almost guarantees that you will regain control of the CKit. You 
should use this method as a last resort, since it usually will cause the CKit to invoke its Fatal 
Error routine. 

Here are a few tips, to help you avoid serial bus problems: 

>' 

1. Keep as many serial devices turned ON as possible (European PAL units especially). 

2. Be sure that your serial bus cables are connected properly. 

3. Avoid having extra devices on the serial bus (printers, interfaces, etc.). 

4. Do not turn a serial device ON or OFF during disk access. 

Commodore 1581 Hardware Problems 

There are a great number of Commodore 1581’s out there that are plagued with some 
hardware bugs that can really confuse your system. Some typical symptoms are: 

□ Serial bus locks up when the 1581 is turned off 

□ Random device not present errors 

□ Unusually high occurrence of data corruption 

If you are experiencing any of the above problems, have your 1581 checked and/or repaired. 
Until then, here are a few tips that may help you bypass some of those problems: 
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TROUBLE SHOOTING 


1. Always leave the 1581 powered ON. 

2. Make sure that there is no disk in your 1581 before turning the drive ON. 

3. Avoid turning other serial devices ON and OFF. 

4. Disconnect all of the unused serial devices from the serial bus (printers, interfaces, etc.). 

5. When all else fails, unplug the 1581 from the serial bus. 

It is important to remember that these tips will not solve your problems. Only a sound 
Commodore 1581 will:' 

Cold Start Reset 

If for some reason the CKit should lockup and every means of recovery that you try fails, you 
have one last option: 

[stop][restore] 

Hold down the [stop] key and tap [restore] until the Server’s Main Menu appears on 
the screen. This key combination cold starts the CKit, as if you just booted it. You should 
only use this command as a last resort. 


NOTE: If this command does not work, then the serial bus is probably locked up (please 
see Serial Bus Problems above). 


Job Errors 


ERROR:Track <t> Se ctor/[return] 


The CKit can not read track <t> sector <s>. This error will occur if the drive is having 
trouble reading a certain sector. This error will also occur if the track or sector is out of 
range (usually caused by corrupted files). 


The verify failed. The CKit detected a corrupted file. This error is most commonly seen 
on drives with bad alignment. This error will also occur on CMD RAMLinks and 
RAMDrives which are having timing problems (usually due to improper installation). 


iRRbiliiiliiiiiai_.. .. 


Sector<s> 




> : si 




The CKit can not read track <t> sector <s>. This error will occur if the drive is having 
trouble reading a certain sector. This error will also occur if the track or sector is out of 
range (usually caused’by corrupted files). 
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TROUBLE SHOOTING 



The CKit can not write track <t> sector <s>. This error will occur if the drive 
encounters a problem while writing a certain sector. Write protect tabs and physically 
damaged sectors are the main cause of this error. This error will also occur if the track 
or sector is out of range. 



The CKit has detected a corrupt track. This error is often caused by badly aligned 
drives. This error will also occur on the decompression of a corrupted CKit boa file. If 
you encounter this error, Mad Man Software recommends that you start the job over and 
use a different Destination disk (if possible). 
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This error occurs if the archive becomes to large. For this error to occur, a limit must be 
selected and the archive must be larger than 2,700 blocks. Should you encounter this 
error, try using a higher limit. In most cases this will solve the problem. 
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The CKit can not find a data file. This error usually occurs when you accidently place 
the wrong Source or Destination disk in the drive. 
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The CKit can not find a data file. This error usually occurs on CMD RAMLinks, 
RAMDrives, and Hard Drives which are missing data files. This error is often caused by 
forgetting to copy all of the necessary data files to the Source. 












The verify failed. The CKit detected a corrupted archive or boa. This error is most 
commonly seen on drives with bad alignment. This error will also occur on CMD 
RAMLinks and RAMDrives which are having timing problems (usually due to improper 
installation). If you encounter this error, Mad Man Software recommends that you start 
the job over. 
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The information at the beginning of the first archive file is corrupted. This error should 
only occur on badly corrupted files. Accordingly, this error occurs on files that were not 
compressed using'the CKit 
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TROUBLE SHOOTING 
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The archive you have selected must be decompressed with a higher version of the CKit. 
Please contact Mad Man Software for CKit update information. 

The file is corrupted. This error indicates that the decompression of the file failed. This 
is usually caused by a corrupted archive data file. 

ERROR tArchive lg>corrnpfcedPt return ■" - 

Indicates that the archive header does not match the archive data. This occurs when the 
CKit does not decompress all of the files that it believes is in the archive. This error is 
quite rare and should only appear on badly corrupted data files. 


ERROR 




IfHi ij|pp 4-$111 M fpl 


The information at the beginning of the first boa file is corrupted. This error should only 
occur on badly corrupted files. Accordingly, this error occurs on files which were not 
compressed using the CKit 
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The boa you have selected must be decompressed with a higher version of the CKit 
Please contact Mad Man Software for CKit update information. 
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■ Chapter 13: NOTES 

Compression 

There are a few things to keep in mind when you use the Compression Kit (CKit) for 
compressing files, disks, and partitions: 

Compressed Files Are Not Executable 

You can not ’run’ CKit data files. You must first decompress the CKit data files, in order to 
return the data back into its original format. 

Guaranteed Compression 

The CKit’s compression routines engage only when actual data compression can take place. 
This means that there should rarely ever be a situation where your CKit data files are larger 
than the originals. 

Fast Compression 

The early test versions of the CKit used a statistical data compression technique. Most of the 
data compression programs available for the Commodore use this same technique. The 
problem with statistical compression is that it requires heavy duty processor time (statistical 
data compression can be very slow). Since the CKit is designed to be a backup utility with 
reasonable speed. Mad Man Software dropped this method of compression and adopted a new 
one. The staff at Mad Man Software settled on several different fast compression techniques 
all integrated together into one master data compression technique. As a result the CKit can 
compress data at a very high speed, three blocks per second or faster. Even more impressive, 
the CKit can decompress data at eight blocks per second or faster (faster than most file copiers 
can write the data). 

Compression Techniques 

The CKit uses data compression techniques that will compress repeated zeros, repeated 
characters, strings of numbers (such as DATA statements in BASIC), Commodore screen text 
(such as the text files generated by most word processors), and Commodore ASCII text (found 
almost everywhere in BASIC and machine language programs). So the amount of data 
compression that you will see depends directly upon the content of the data being compressed. 

Compressed Files Will Not Compress 

Once you compress data, do not try to compress the data again. The CKit will try to compress 
the data again but no compression will actually take place. 
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NOTES 


Tips 

Use The Archiver Whenever Possible 

The Archiver compresses the files that you select and nothing else. The Boas compress every 
single sector on the disk or partition. So try to use the Archiver for most of your backups. 
Another advantage of using the Archiver, is that you can examine the data within your backups 
without having to decompress them first (with the Examine Archive option). 

Avoid Compressing Dirty Disks Or Partitions 

If you have a disk or partition that at one time or another had less blocks free than it has now, 
then some of that data is still sitting out there on your disk or partition. Since the Boas 
compress everything, they will compress that extra data as well. This will cause the compressed 
files to be larger than they need to be. Your solution: Use the Archiver whenever possible, 
or copy the data to a newly formatted disk or a zeroed out partition (using the Filemaster) 
before using a Boa. 

Format Disks Outside Of The CKit 

Some of the Commodore drives do not support standard DOS error handling when executing 
the format command. This can cause strange error messages and fatal errors within the CKit. 
To be safe, do your formatting outside of the CKit in BASIC. You can always return to the 
CKit by using the SYS4 safely feature. 

Always Use The Verify Option 

Every utility in the CKit contains a verify option. The verify option defaults to ON for good 
reason. This feature guarantees the integrity of your backups. The verify feature is extremely 
important when copying or decompressing disks. Turning the verify feature OFF will speed 
up the backup process but MAD MAN SOFTWARE MAKES NO GUARANTEES ON THE 
INTEGRITY OF YOUR BACKUPS. 


54 


The Compression Kit vl.00 


NOTES 


Getting Maximum Performance 

The CKit is designed to support almost every hardware setup possible for the Commodore 
64/128. In order to maintain this high degree of flexibility, the CKit makes heavy use of stock 
DOS routines. Often times the stock DOS routines on the Commodore drives can be quite 
slow. For the fastest operation possible Mad Man Software recommends that you upgrade 
your computer with CMD’s Jiffy DOS. JiffyDOS is a ROM upgrade for your computer and 
disk drives. The speed increase with this upgrade alone can be up to %1500 (15 times faster). 
If you use your disk drives for more than games, you should seriously consider upgrading. 


NOTE: The CMD RAMLink and RAMDrive have JiffyDOS built in. Keep this in mind 
if you plan on upgrading soon. 
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